home *** CD-ROM | disk | FTP | other *** search
/ PC Media 23 / PC MEDIA CD23.iso / share / prog / anubis / vscroll2.txt < prev    next >
Encoding:
Text File  |  1995-08-04  |  3.6 KB  |  109 lines
  1.         Especificaciones para la librería VSCROLL2.H
  2.         --------------------------------------------
  3.  
  4.     Esta librería está pensada para utilizar barras de deslizamiento 
  5. dentro de una ventana determinada.
  6.     Las barras de desplazamiento tienen mucha utilidad en el sentido
  7. de que dan una forma elegante de seleccionar entre una lista de
  8. muy diversos objetos.
  9.     Esta versión a sido concebida para utilizarse dentro de ventanas
  10. en el entorno AVISION.
  11.  
  12.     A continuación describiremos la estructura básica de la librería:
  13.  
  14. typedef struct {
  15.    char AI;
  16.    --------
  17.     Este caracter especifica el caracter superior izquierdo del marco
  18. del scroll.
  19.     char AD;
  20.     --------
  21.     Este caracter especifica el caracter superior derecho del marco 
  22. del scroll;
  23.     char AbI;
  24.     ---------
  25.     Este caracter especifica el caracter inferior izquierdo del marco
  26. del scroll.
  27.     char AbD;
  28.     ---------
  29.     Este caracter especifica el caracter inferior derecho del marco
  30. del scroll;
  31.     int PosX;
  32.     ---------
  33.     Esta variable indica la posición en la que empieza el scroll. Es
  34. decir, la posición (en coordenadas ventana, empezando por 0) de la
  35. posición más a la izquierda del scroll.
  36.     int PosY;
  37.     ---------
  38.     Esta variable indica la posición en la que empieza el scroll. Es 
  39. decir, la posicion (en coordenadas ventana, empezando por 0) de la
  40. posición más superior del scroll.
  41.     int Ancho;
  42.     ----------
  43.     Esta variable indica el ancho total del scroll.
  44.     int Alto;
  45.     ---------
  46.     Esta variable indica el alto total del scroll.
  47.     char Nombre[40];
  48.     ----------------
  49.     Esta cadena de caracteres da un nombre al scroll.
  50.     char * *lista;
  51.     --------------
  52.     Esta apuntador a una cadena de apuntadores a cadenas de caracteres
  53. es la estructura básica para simular el texto del scroll. En realidad
  54. no es más que un apuntador al texto que se va a representar.
  55.     int AparY;
  56.     ----------
  57.     Esta variable auxiliar es un apuntador al contenido que aparece
  58. en la parte superior del scroll. Se empieza por cero.
  59.     int PosRel;
  60.     -----------
  61.     Esta variable auxiliar indica la posición del scroll que está
  62. seleccionada en el momento actual. Y así se tiene una referencia para
  63. cuando se pulse RETURN.
  64.     Ventana2 *Ventana;
  65.     ------------------
  66.     Esta variable apunta a la ventana que contiene el scroll.
  67.    char CFondo;
  68.     ------------
  69.     Esta variable indica el color de fondo.
  70.     char CTexto;
  71.     ------------
  72.     Esta variable indica el color del texto.
  73.     char CSeleccionado;
  74.     -------------------
  75.     Esta variable indica el color de fondo del texto seleccionado.
  76.  
  77. } VScroll2;
  78.  
  79.  
  80.     A continuación vamos a especificar los prototipos de funciones para
  81. utilizar estos tipos de scroll.
  82.  
  83. void DibujarVScroll( scroll);
  84. -----------------------------
  85.     VScroll2 scroll;
  86.     ----------------
  87.     Indica el scroll que queremos dibujar.
  88.     Esta función simplemente dibuja el scroll indicado en la ventana
  89. especificada, y lo pone todo en el estado que se desea.
  90.     
  91.  
  92. int EvntVScroll( scroll);
  93. -------------------------
  94.     VScroll2 scroll; Indica el scroll que va a usarse.
  95.    
  96.     Esta función lo que hace es comprobar si se ha producido un evento
  97. de scroll y devuelve el valor apropiado. Estos valores pueden ser:
  98.     VSCROLL_PULSADO: Se ha pulsado sobre un item del scroll.
  99.     VSCROLL_ARRIBA:  Se ha pulsado sobre el botón de arriba del scroll.
  100.     VSCROLL_ABAJO: Se ha pulsado sobre el botón de abajo del scroll.
  101.     VSCROLL_DESLIZAMIENTO: Se ha pulsado sobre el boton de deslizamiento
  102. del scroll.
  103.  
  104.  
  105. void VScrollEvnt( scroll);
  106. --------------------------
  107.     VScroll2 * scroll; Indica el scroll sobre el que se ha dado un evento.
  108.     Esta función lo que hace es tratar cada uno de los eventos que se
  109. hayan producido sobre el scroll.